OpenEdge Application Server:<br />Administration Eliminating the NameServer

Eliminating the NameServer

Use of the NameServer is optional. There are several reasons why you might want to eliminate the NameServer from your configuration:

The NameServer allows for location transparency and load balancing. Simple or static configurations might not require those features.

The communications protocol employed by the NameServer is the User Datagram Protocol (UDP). Some sites have restrictions that prohibit the use of UDP.

If you choose not to use the NameServer, configure your Transaction Server to indicate that it should not register with a NameServer. Then, configure your Messenger to connect directly to the Transaction Server.

To eliminate the NameServer using Progress Explorer:

Open your broker’s Properties dialog box.

Select Controlling NameServer under the Broker node.

Deselect the Register With NameServer check box.

Choose the OK button.

Open your Messenger’s Properties dialog box.

Select the Controlling NameServer node.

Deselect the Connect Using NameServer check box.

Type the hostname and port number of the broker.

Choose the OK button.

You can also eliminate the NameServer by directly editing the ubroker.properties file, although using Progress Explorer is less error prone.

To eliminate the NameServer by editing the ubroker.properties file:

Open install-dir/properties/ubroker.properties in a text editor.

Find the broker definition for your Transaction Server. For example:


[UBroker.WS.wsbroker1]

Note that wsbroker1 is the name of the Transaction Server.

Add and set the following property:


registerNameServer=0

Or, if registerNameServer is already set to 1, reset it to 0.

Find the definition for your Messenger. For example, if you use CGIIP:


[WebSpeed.Messengers.CGIIP]

Add and set the following property:


registerNameServer=0

Or, if registerNameServer is already set to 1, reset it to 0.

Add and set the port number for your broker. For example, if you are using the default wsbroker1:


Port=3055

Save and close the ubroker.properties file.

Note: When you eliminate the NameServer, the Messenger can only access one WebSpeed Transaction Server (broker). One of the advantages of using the NameServer is that you can run multiple brokers.